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1 Introduction 



This manual provides installation instructions for the IMS D7305A Occam 2 
toolset for the IBM 386 PC {and compatibles). In addition instructions for testing 
the release are given. 

1.1 Layout of this manual 

Chapter 2 provides installation instructions for this release. 

Chapter 3 contains a simple procedure to check that the installation has been done 
correctly. 

Appendix A contains some distribution notes for this release. 

Appendix B shows the positions of the debugger and simulator function keys on 
a standard PC keyboard. 

Appendix C contains details of the DOS extender used with this release. 

1.2 Prerequisites for running the toolset 

In order to use the occam 2 toolset you will require: 

• An IBM 386 PC {or compatible) with at least 4 Mbytes RAM. 

• DOS version 5.0 or later. 

• About 11 Mbytes of free disk space. 

• An IMS B004 or BOOS (or similar) transputer board with an INMOS 32-bit 
transputer such as an IMS T800 or T414 (Rev B or later), with 2 Mbytes 
or more of memory. 

Note: For interactve debugging a 32-bit transputer is used to run the debugger, 
so to use thisfeatureofthe toolset at least one additional transputerwiil be needed. 

1.3 Compatibility with previous releases 

This release is source code compatible vwth the previous D7205A release of the 
toolset. Users should recompile all source code with this new toolset. 

This release is compatible with the D7314A ANSI toolset supplied by INMOS. 
Together these toolsets can be used for mixed language programming in C and 

Occam. 
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1.3 Compatibility with previous releases 
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2 Installing the release 



This release of the IMS D7305A OCCam 2 toolset comes on three 1.2 Mbyte 
5.25 inch floppy disks and three 1 .44 Mbyte 3,6 inch floppy disks. The installation 
procedure is the same whether you install from the 1.2 Mbyte disks or the 
1.44 Mbyte disks. You will require about 11 Mbytes of free disk space during the 
installation process, although the installed product only occupies about 9 Mbytes. 

The whole release will be installed by the installation procedure, to make the 
process as easy as possible. You can delete some of the components after instal- 
lation if you wish. 



2.1 Installation 

To install the release first insert Disk 1 in your floppy disk drive. Next run the batch 
file, install -bat, on Disk 1, giving as parameters the drive letter of the floppy 
disk drive and the drive on which the toolset will be installed. 

For example, if your floppy disk drive is A, and the drive on which you want the 
toolset installed is C, type: 

a; install a c 

Installation will then proceed. Periodically you wi[l be asked to insert further disks 
into the disk drive until all the software has been transferred to the PC hard disk. 

If the Installation has been successful the following messages will be displayed at 
the end of installation: 

Installation complete 

You may delete install2.bat 

IN5TALL2 . BAT is the batch file which installed the release. It is no longer required 
and so may be deleted. 

The installation procedure creates a directory called \D7305A. All the components 
of the toolset itself are copied into sub-directories of \d7305a, as shown In the 
following table: 
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2.2 Hosted and non- hosted tools 



Directory 


Contents 


\D7305A\ TOOLS 


The tools. 


\D7305A\LIBS 


The toolset libraries and indude files. 


\D7305A\EXAMPLES 


Example sources. 


\D7 305A\EXAMPL£S\MA2;rUMiS 


Examples found In the user manuals. 


\D7305A\EXAMPLES\IDEBUG 


Examples for use with idebug. 


\D7305A\EXAMPLES\MIXED 


Mixed language example sources. 


\D7305A\EXAMPLES\MIXCONF 


Mixed language configuration example 




sources. 


\D7305A\EXAMPLES\OC 


Occam compiler example sources. 


\D7 305 A\EXAMPLE S \OCCONF 


Configurer example sources. 


\D7305A\SOURCE 


Released sources. 


\D7305A\SOURCE\lMftKEF 


Sources for the imakef tool. 


\D7305A\SOORCE\ISERVER 


Server sources. 


\D7305A\SOURCE\DRIVER 


Driver program sources. 


\D7305A\SOURCE\LIBS 


Library sources {in sub directories). 


\D7305A\SOURCE\BOOTSTRP 


Sources for the bootstraps. 


\D7305A\ITERMS 


Example ITERM files. 


\D7305A\CONNECT 


Sample iserver connection database files. 



Users of the previous Occam 2 toolset ([MS D7205) will notice that the itools 
and iserver directories no longer exist. 

The release installation procedure installs everything onto the hard disk. Certain 
parts of the toolset release may be removed from the hard disk if disk space is a 
problem. The following table indicates which parts of the release are essential for 
its cored operation. 



Component 


Necessary 


Tools 


yes 


Libraries 


yes 


Iterms 


yes 


Connect 


yes 


Source code 


no 


Examples 


no 



The source and examples directories are not strictly needed for the operation 
of the toolset, but it is recommended that you leave them installed, at least initially, 
as they provide many useful examples of Occam programs, some of which are 
refen^ed to in the manual. 

2.2 Hosted and non-hosted tools 

Most of the tools in this release execute on the PC host. However three tools, 
namely idebug, idun^, and iskip execute on a transputer 
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2 Installing the release 



2.3 Setting up the toolset for use 

This section explains how to set up the environment necessary to use the toolset. 
It describes the basic changes to the system configuration file CONFIG , SYS whfch 
you should make before you attempt to use the toolset and shows how to set up 
the necessary environment variables. 

The commands described below to set up the toolset may be added to your 
AUTOEXEC , BAT file SO that the toolset will be set up whenever you switch on your 
PC. 



Z3.1 Setting the files variable 

The FILES command In your system configuration file config.sys should be 
changed or added to specify at least 20 simultaneously open files. Far example: 

FILES=20 

Note; Any other file handling software used on the system (such as PC-NFS) 
should also be reset to accept at least 20 simultaneously open files. 

2.3J2 Setting the correct PATH 

To be able to use the tools you will need to add the directory c : \d7305a\ tools 
to your path. 

For example to set your path to your system commands and then the toolset (on 
drive C), type: 

PATH=C : \DOS ; C : \D730SA\ TOOLS 

Note : If you are using more than one INMOS toolset then make sure that the 
newer toolset appears first on the path. This makes sure that you will always use 
the latest version of any tool which is common to all toolsets, e.g. ilink. To 
determine which toolset is the newer you can invoke the common tools from each 
toolset until you find an Instance where the version dates differ, the tool with the 
newer version date belongs to the newer toolset. 

2.3.3 Configuring the DOS extender 

The majority of the tools which execute on the PC run in protected mode, and so 
require a DOS extender. This toolset is supplied with the dos/4gw DOS extender. 
It can be found in the directory D7305A\tools and is executed automatically 
whenever you invoke one of the PC hosted tools, 

D0S/4GW should be able to determine automatically what type of machine it is 
running on, and set the switch mode settings (how to transferfrom real to protected 
mode) appropriately. However for a few machines D0S/4GW must be configured 
manually. 
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2.3 Setting up the toolset for use 



This toolset includes a program, pminfo, which can be used to check the switch 
mode settings on your machine, pminfo can be found in the \D7305a\tools 
directory. 

Run the PMINFO program as follows: 

Opminfo 

[fall is well PMINFO displays a report of the protected-mode resources available 
to your programs. The last line of the report will be something like the following 
(although possibly with a different switch mode value): 

using DOS/IGM switch mode 11 (VCPI) 

If PMINFO does not work correctly then you may have to configure the DOS 
extender manually. Please read appendix C, section C.3, for details of how to do 
this, 

PMINFO is described in more detail in section C.4. 

Whenever a PC hosted tool starts up a message is displayed by the DOS extender 
If you want to disable this message then set the dos4g environment variable as 
follows: 

Oset D0S4G=quiet 

See section C.3.1 for more details. 

2.3.4 Setting up the iserver 

The iserver is a program which runs on the host machine and provides access to 
the facilities of that machine, e.g. the file system. 

Selecting the required iserver 

Two versions of the iserver are provided with this toolset. One which works with 
PC-NFS and one which works with PCn"CP. These iservers are found in the 
\D730SA\TOOLS directory with the following names: 

ISERVER, NFS : iserver for use with PC-NFS. 
ISERVER- TCP : iserver for use with PC/TCP. 

If you have neither PC-NFS nor PC/TCP installed on your PC then INMOS recom- 
mend the use of the PC-NFS version. 

Having selected the required iserver make a copy of it in the \D7305A\TOOLS 
directory with the name iserver.exe. 

Example: If you require the PC-NFS version of the iserver then the following 
commands would work: 

Ocd \d7305a\ tools 

Ocopy iserver, nfs iserver.exe 
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2 Installing the release 



Special notes for users of the PC-NFS iserver 

In order to make use of the PC-NFS iserver it may be necessary to upgrade your 
version of NFS. INMOS supply a program which checks your NFS installation and, 
If necessary, upgrades it to the level required by iserver The upgrade entails 
replacing some of the files in your NFS installation with newer versions. 

The upgrade program, called upgrade . exe, can be found in \d7305a. All users 
of the PC-NFS version of the iserver should run the upgrade program as shown 
below: 

Ocd \d7305a 

Oupgrade c : \d7305a\ nf s-mods . exe 

The upgrade program asks some questions regarding your PC-NFS installation 
and if required will upgrade NFS. Note: upgrade will only upgrade PC-NFS if you 
elect to do so. 

Notes common to both versions of the iserver 

The iserver supplied with this toolset supersedes any previous version. Unlike 
previous versions which required a separate executable file for each link device 
supported, this iserver contains drivers for all link devices in a single executable. 
This means that each time the iserver is used, it must be told which driver to use. 
This is achieved by use of a Connection Database. 

A connection database is a text file which contains a description of all the links 
available to the isen^er, and enough information to allow the iserver to choose the 
con'ect one. Each link is given a name called the capability name. 

When the iserver is executed a capability name must be supplied by the user 
(either explicitly or via an environment variable). The capability name is translated 
into a link name via the connection database. 

Sample connection databases containing descriptions of some common INMOS 
hardware are supplied with this toolset. They can be found in the directory 
G: \D7305A\CONNECT, and are listed in the following table: 



File 


Supported hardware 


Capability name(s) 


B004.DAT 


IMS B004 board 


B004 


B008.DAT 


IMS B008 board 


8006 



Thus the capability name for the IMS B004 is B004, for the IMS 8008 is B008. The 
entries in the sample connection databases are con-ect for boards which were 
installed at the default addresses and/or with the default names as described in 
the relevant Installation guide. 

For detailed information on the format of a connection database see the iserver 
chapter in the occam 2 Toolset Reference Manual. 
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2.3 Setting up the toolset for use 



The iserver makes use of two environment variablesj icOndb and transputer. 

ICONDB specifies the whereabouts of the connection database file. This should be 
set to refer to the connection database which matches your hardware, e.g. to set 
up the connection database for a B004 use the following: 

set ICONDB=C: \D7305A\CONNECT\B004.DAT 

TRANSPUTER specifies the default capability name to use. So for the B004, 
TRANSPUTER should be set as follows: 

set TRANSPUTER=B004 

The default capability name can be overridden using the iserver SL option. 

See the iserver chapter in the Occam 2 Toolset Reference Manuatlor more details 
about the use of the iserver. 

Note for users of the IMS BOOS motherboard 

The BOOS motherboard can be accessed either directly from the iserver or via the 
8008 device driver, supplied with IMS S708b. If you have installed the device driver 
(note this often dashes with Mouse Drivers and is no longer recommended), then 
you should use a connection database based on the example BOOS .DAT file. If, 
however, you do not have the S708b device driver installed (this is the recom- 
mended method), then you should use a connection database based on the 
example BO 04 . DAT file. An entry in such a connection database would be some- 
thing like: 

IB008 |T|localhost|#150|b004f | |Description . . . | 

Note the use of b004 in the 5th field. For historical reasons the iserver which 
accesses the BOOS motherboard directly is known as the B004 iserver. 

2.3.5 Use of the iserver by transputer tool driver programs 

Driver programs are supplied for use with the transputer hosted tools. These 
drivers invoke the iserver in order to boot the tools onto the transputer 

Normally the iserver invoked by the transputer tool driver programs is the same 
as that which is found on the system path. It can be changed to a different server 
by defining the environment variable iserver. If iserver is defined on the 
system then the driver programs use the iserver specified within it, otherwise the 
server is searched for on the default path. 

The ISERVER variable should contain the full directory path and filename of the 
altemative iserver. For example, to use a servercalledMYSERVER.EXE from your 
\BIN directory on drive C, use the following definition: 

set ISERVER=C: \BIN\MYSERVER.EXE 
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2 Installing the release 



Note: Setting ISERVER does not affect the iserver which is used when i^erver 
is invoked from the command line; it only affects use of the iserver from within 
driver programs. 

2.3.6 Setting the board memory size 

Before you can use any tool which runs on your transputer evaluation board you 
must set up an environment variable, iboardsize, giving the size of the memory 
on the board (in bytes). To do this use the DOS set command. For example, to 
set a board size to 2 Mbytes type: 

set IBOARDSIZE=#200000 

You may give either a decimal or hexadecimal (preceded by '#' and using upper 
case letters only) number On keyboards without *#', the '5' character can be used 
instead. Leading and trailing spaces are prohibited. 

If IBOARDSIZE is specified incon^ectly, for example as a character, string or with 
leading or trailing spaces, the system defaults to a board size of (zero) and 
transputer programs will fail to run. If iboardsize is explicitly set to a very small 
value a similar error may occur 

2.3.7 Setting root memory size for idebug 

The amount of memory on the root transputer must be defined for idebug, using 
the envin^nment variable IDEBUGSIZE. This variable is set up in the same way as 
IBOARDSIZE (see section 2.3,6) and should be set to the available memory. 
Leading and trailing spaces are prohibited. 

The debugger requires at least 1 Mbyte of available root transputer memory: it is 
strongly recommended that 2 Mbytes or more be available. 

2.3.8 Setting a file system search path 

To enable the tools to find libraries and include files you must set up an environ- 
ment variable called iSEARCH. This environment variable will normaily give the 
standard library and include file directory (\d7305a\libs\) and any user directo- 
ries as required. Note that unlike the DOS path you must add the closing back- 
slash, '\'. to a directory name. Directories may be separated by a space or a 
semi-colon. For example, to set up iSEARCH to point to the standard include fifes 
and libraries and to a user directory called \MYDIR, type the following DOS 
command: 

set ISEARCH-C:\D7305A\LIBS\;C:\MYDIR\ 

Note : All INMOS toolsets use ISEARCH. If you are using more than one INMOS 
toolset then ISEARCH should be set up to point to the libraries and Include files for 
each toolset plus any other user directories. The most recent toolset should 
appear first in the list. 
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10 2,3 Setting up the toolset for use 



Z3.9 Setting the device driver and terminal definition file 

In order to use the interactive tools it is necessary to install a device driver for the 
screen. The device driver to use is ANSI. SYS which rs supplied as part of DOS. 
It is likely that ANSI.SYS is already installed on your PC, If not the following is an 
example of the line which is required in your CONFIG.SYS file :- 

DEVICE=C : \DOS\ANSI . SYS 

You will need to re-boot the PC in order for the ANSI.SYS device driver to be 
installed. 

The interactive tools idebug and isim need keyboard and screen mappings 
which are specified in what are known as ITERM files. The environment variable 
I TERM must be set to point at one of these. An ITERM file su itable for use with the 
PC and ANSI.SYS is supplied and may be set up In the following way; 

set ITERM=;C:\D7305A\ITERMS\PCANSI.ITM 

ITERM files are text files which describe the mappings between escape 
sequences and screen commands/keys. New ITERM files for non-standard temil- 
nals may be created by copying the supplied file, editing it and setting the ITEFM 
environment variable accordingly. 

For a description of ITERM files see appendix D in the OCCam 2 Toolset Reference 
Manual. 



2.3.10 Environment space 

The PC may not have enough environment space by default. This may need to be 
increased in order to run the toolset. 

In DOS version 5.0 {and compatible versions) the shell command In the 
CONFIG.SYS file can be used to set up an environment size when the PC is 
booted. For example: 

SHELL=coniiiiand.coiii /e:1024 /p 

This example gives the name of the DOS command processor, sets the environ- 
ment space to 1024 bytes and makes this version of the command processor 
permanently resident. 

Alternatively a new command interpreter can be started from inside the normal 
one, specifying the new environment size: 

COMMAND /e:1024 

This command interpreter can be terminated by typing exit to return to the 
resident one. However this technique will reduce the memory available as two 
copies of the command interpreter will be running. 
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11 



2.3.11 Setup checklist 

The following is a checklist of the actions required to set up the toolset. The second 
column gives the section of this document where the action is described. 



Action 


Section 


Set up the DOS files variable 


2.3.1 


Extend the system path 


2.3.2 


Configure the DOS extender 


2.3.3 


Select the required version of the iserver 


2.3,4 


Run the PC-NFS upgrade program 
(PC-NFS iserver only) 


2.3.4 


Set up the ICONDB environment variable 


2.3.4 


Set up the TRANSPUTER environment variable 


2,3.4 


Set up the ISERVER environment variable (optional) 


2.3.5 


Set up the IBOARDSIZE environment variable 


2,3.6 


Set up the idebugsize environment variable 


2.3.7 


Set up the iSEaRCH environment variable 


2.3.8 


Set up the ANSI . SYS device driver 


2.3.9 


Set up the ITERM environment variable 


2.3.9 


Extend the DOS environment space if required 


2.3.10 
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3 Confidence testing 



This chapter describes a short procedure which may be followed to check that 
installation has been done correctly. 

A simple example program is compiled for the TA processor class and executed 
on a T425 transputer. Compiling for the TA class allows the program to be run on 
any 32'bit transputer such as the T425. 

tf there is no transputer available then the program may be executed using the 
simulator as long as it is built for a T425 target (which this example allows because 
it Is compiled for the TA class). 

3.1 Building the example 

1 Set the current disk to the same disk as the toolset has been installed on. 
For example, If the compiler has been installed in directory c : \D7305Af 
do this: 

D>c: 

C> 

2 Set the current directory to a convenient directory for doing this test. For 
exampie: 

Omkdir \mine 

C>cd \inine 

C> 

3 Copy the example files single, occ and single. pgm to the current 
directory: 

Ocopy \d7305a\exaniple3\iiianuals\simple\siii^le *occ 
1 ?ild(s) copied 

Ocopy \d7305a\exaniples\inanuals\siinple\simple.pgm 
1 File(s} copied 

C> 

4 Compile the example for the TA processor class: 

C>oc /ta simple. occ 

D0S/4Gtf Protected Mode Run-time Version 1 . 8 

Copyright (c) Rational Systems, Inc. 1990-1992 

C> 
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14 3.2 Running the example program 

The D0S/4GW start up message will not appear if you have suppressed 
it using the D0S4G environment variable (see section C.3.1}. 

If you have not set the D0S4G environment variable and the D0S/4GW 
start up message does not appear, or is followed by a message from the 
DOS extender, checic the instructions given in section C.3 on the settings 
fortheDOSl6M environment variable. Another possible problem is insuffi- 
cient extended memory betng available. If this is the case then you will 
have to reduce the amount of memory being used by other programs. 

5 Link the resulting binary file with the necessary parts of the run-time library: 

Oilinlc /ta ^iitcple.tco hostio.lib /£ occama.lnlc 
C> 

6 Configure the program. This stage makes use of a configuration descrip- 
tion file which describes the hardware that the program is to run on. The 
file simple, pgm is such a file and describes a simple network of a single 
T425 with 1M of memory which is connected to the host through link (it 
also suffices for programs which will be run on the simulator). You will need 
to edit this file if your hardware configuration is different (see the chapter 
of the Occam 2 Toolset User Guide entitled Configuring Transputer 
Programs for details of configuration). This example has been compiled for 
the TA transputer class which is suitable for a T425 ^ansputer. 

The command is as follows: 

C>occonf simple. pgm 

C> 

7 Add bootstrap code to the configured file. The bootstrap code loads the 
application onto the transputer and starts it executing ; 

C>icollect simple. c£b 

O 

3.2 Running the example program 

Finally, the program can be run on a transputer: 

Oiserver /sb simple. btl 

This will display the following if the name 'Bruce' is given: 

Please type your name :E£iifflfe 
Hello Bruce 

C> 
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3 Confidence testing 1^ 



The output 'Hello Bruce' comes from the simple . occ example program. 

If, instead of the c> prompt, the computer outputs an error message reporting 
problems with the link resource name or a message similar to: 

Failed to open connection to transputer because: 

is displayed, then check that the iserver is correctly set up {section 2.3.4). The 
reason displayed by the error message should indicate where the problem is. 

Another potential source of problems is that the Iserver cannot communicate with 
the transputer hardware. This will result in an error message similar to: 

Error - iserver - protocol error . . . 

In partfcuJar, please check that any wire links, accessible from the back of the PC, 
have been correctly installed, and any jumpers have been set con-ectly. The 
transputer board's documentation should help with this. 



3.3 Using the simulator 

The example program can instead be executed on the transputer simulator which 
is supplied as part of the toolset The simulator simulates an IMS T425 transputer 
Since we compiled the example for ta, which means it will run on any 32-bit 
transputer, we can use the same executable program: 

Oisim /bq aijnple,btl 

O 

Display produced when the name 'Bmce' is used: 

Please type your name : Bruce 
Hello Bruce 



72 TDS 389 01 April 1993 



16 3>3 Using the simulator 
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A Distribution notes 



A.I iserver source 

The directory /D7305a/Source/iserver/ contains the sources forthe host file 
server. The server source is partitioned into three components which must be built 
in the following order: 

linkios 

linkops 

iserver 

Each component contains a single src directory which contains the source files 
and makefiles for that component. The makefiles are designed in such a way that 
they work within a copy of the src directory which should appear at the same level 
as src but with a name taken from the host dependent suffix to the makefile, e.g. 
In order to build a PC version of the iserver each component should contain a copy 
of the src directory called pe in which the makefile makefile. pc should be 
invoked. 



A.2 Driver program errors 

The transputer based tools are executed through a driver program which itself 
generates error messages. 

Fatal*'driver- unable to execute 'idebug' , Arg list too long 

In this example the messages indicates that the DOS limit on the length of the 
command line has been exceeded. 

Driver errors are generated for limitations or en"ors such as a command line too 
long, denial of read/write access to a file, and file or directory not found. 
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18 A.2 Driver program errors 
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B Debugger function 
keys 



This appendix gives the keyboard assignments for the debugger symbolic func- 
tions for both the IBM 386 PC and compatibJes (PCANSI . ITM) Some of the keys 
are applicable to the simulator as well. 



B.1 IBM 386 PC LH-keypad 





F1 


F2 


Ctrl 






Shift 

Art 




Cont from 




Help 




Ctrl 
Shfft 
Alt 


IZZZI 


Change Fiie_ 








Ctrl 

sum 

Att 


_SearctL _ 
JogoJeHB3(_ 
Gat AddrKs 


TopgleBr^ak 


Ctrl 
Shift 
Alt 


DeJete_ Une 
-*- Line 


~IinT^^ 


Ctrl 
Shitl 
Alt 


TOE dT File 

Line Up 


_EndofFi!e 

_PaaejDqwn_ 

Line Down 



F9 



F10 
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B.2 Keyboard layout for IBM 386 PC - left 



Esc 



Rflttesrt 





F1 


F2 


F3 


F4 




F5 


F6 


F7 


F8 


CM 










Ctrl 




l^jg^Brt.* 






Shift 








Change File 


Shin 


Search 




'* WcjTd 


Word *- 


Ali 




Conl rrom 






Aft 


Toggle HaJ? 




Delete Linf 






Help 










GetAddresd OobsLine 


4 Une 


Line *- 





AlH 1 






2 






3 




4 




5 




6 




7 




8 






9 






Inspect 


Clianne 


Top 


Retrace 


Relocate 


Info 


Modify 


Resume 


Monito 








Q 


w 


E 


R 




T" 

Top of 


Y 


Delete 
Line 


1 











A* 


S 


D 


F* 


G" 


H 


J 


K 


L 






Interrupt 






Word 


Word 














Z 


X* 


G 




V 


B* 


N 


M 












Deiete 








End of 














Line 








File 



























*ar1 + key 
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B.3 Keyboard layout for IBM 386 PC - right 



F9 


F10 


F11 


F12 


l^DpofFiie" 
PageUp 
CmeUp 


^Er>d oTfTis 
Page Down 
~LTnQ"Cbwn 


;Ez: 






Shift 
Alt 



Alt 



Backspace 



Esc 



Backtrace 



Return 
Ent&r 



Ctfl 



Refresh 








Enter 
File 


* 


Exit 
File 




■* 




*■ 




Finish 


+ 
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All of the tools provided in this toolset will only run on a '386 or higher PC. This is 
because they use the full 32 bit capability of the '386 processor, to give access to 
a large memory space and 32 bit registers. To do this, and still remain compatible 
wfth MS-DOS, the applications use a DOS extender, and possibly an extended 
memory manager. 



C.1 Installation 

The DOS extender used by the toolset is D0S/4GW. This is a subset of the 
Rational Systems DOS extender D0S/4G, specially customized for use with the 
WATCOM C/386 package, which is used to generate the tools in the toolset. To use 
this it is simply necessary to ensure that the DOS extender executable 
(D0S4GW. EXE) is accessible through the path environment variable. The installa- 
tion script places this file in the TOOLS subdirectory, which should be on the path 
anyway. 

Note that the version of the DOS extender supplied with the toolset is 1.8. This 
version, or a later one, is required for reliable operation of the toolset, so if a 
WATCOM product is also installed on the PC, ensure that the correct DOS 
extender is found. 

A limited amount of configuration may be required before tools from the toolset can 
be run. When doing this it can be very useful to run PMINFO, This program is 
provided by Rational Systems and will display useful information about the system. 
If PMINFO will not run then consult section C.3 for further details of configuration 
options. 

The most common problem which may be faced when starting to run the toolkit is 
ensuring that sufficient extended memory is available. Few applications use this 
directly, and so it may be used by disk caches, RAM disks, or expanded memory 
simulators. If this is the case some of these will have to be removed from the 
system, or their memory requirements reduced. 

If D0S/4GW finds that an extended memory manager which uses one of the main 
disciplines is already installed, it wi[l co-operate with it to use extended memory. 
To find out if there is an extended memory manager present, run PMINFO. In the 
final line of the output will be shown the switch method. This is the technique which 
is used to switch between real mode and protected modes (see section C,2.1 for 
the meaning of these terms). If there is no memory manager, then PMINFO will use 
switch method 3 (386), and D0S/4GW will manage the memory itself. 
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C.2 '386 Background 

Most of the time the use of the DOS extender will be invisible to the user However 
if problems do occurthe following sections give some background on the concepts 
involvedj before discussing the options which can be used to control the DOS 
extender 



C.2.1 '386 basics 

The 386 is able to operate in three basic modes; 

real mode This is the default mode, in which the '386 emulates an 8086. All regis- 
ters are 16 bits wide, and so this is sometimes called 16 bit mode. This is the 
mode in which MS-DOS njns, limiting a program to 540K memory. 

protected mode This mode supports hardware memory protection and paging. 
On a '386 this enables an application to access up to 4Gbytes memory, and 
all registers are extended to 32 bits, so it is sometimes known as 32 bit mode. 
This is the mode in which tools from the toolset run. 

virtual 86 mode In this mode the '386 emulates an 8086, however it is imple- 
mented as part of the protected mode^ allowing the memory management 
hardware to be used, and execution of certain instructions to be controlled. 
This is used by operating systems to support DOS applications, which think 
they are running on a real 8086, however all input and output ts actually being 
redirected via the operating system. This mode is used for the DOS pnsmpt 
in MS-Windows. We won't consider this mode any further. 

Because it is possible to switch between real mode and protected mode, an 
application can be started from MS-DOS, running in real mode, switch to protected 
mode to run, and then return to MS-DOS for operating system support. This 
switching is controlled by software called DOS extenders, which control the execu- 
tion of the application in protected mode, and make DOS calls available to the 
application. 

C.2.2 Memory 

Since the introduction of the original 8086 based PC, various methods have been 
used to make more memory available. As a result there are now a large number 
of 'types' of memory possible on a PC. Figure C.I shows a memory map of a 
typical PC. 
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Extended 
Memory 



Conventional 
Memory 



High merrtory Area 

Upper 

Memory 

Area 



DOS 

Memory 



1088K(1M+64K) 
1024K(1M) 



640K 



Figure C,1 Memory layout 



Conventional Memory 



The original 8086 had a 1 Mbyte address space, that is, it could directly access up 
to 1Mbyte of memory. When IBM used the 8086 in the first PC they divided this 
address space into 640K which could be filled with RAM, and the remaining 384K 
was reserved for memory mapped hardware (such as graphic cards) and ROMs. 
MS-DOS was designed to run on this hardware and so contains a memory 
manager for the lower 640K. Thus this memory is called 'conventional memory' 
as it is supported on all systems. 

The upper memory area does not normally contain memory, and so cannot 
normally be used for storing programs or data. However techniques do exist which 
allow backfilling of this address space so that device drivers can be placed there. 

Expanded Memory 

The first solution to the memory problem was Expanded Memory. This provided 
an application with up to 32 Mbytes of additional memory. The problem was that 
the memory could only be accessed through four 'pages', each of 1 6K which were 
mapped into a fixed place in the address space, usually In upper memory. Access 
to this memory was via another memory manager, the interface to which was 
defined by Lotus, Intel and Microsoft, and so is sometimes called the LIM standard, 
although it is more correctiy named the EMS (Expanded Memory Specification). 

This system had the advantage that it could be used on the 8086, but required 
additional hardware. Once the '386 had been introduced it became possible to 
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implement expanded memory in software, using device drivers such as 
EMtd3d€ . SYS. However it is mainiy used now for backward compatibility. 

You may also come across the Enhanced Expanded Memory System (EEMS). 
This is a superset of EMS which allows more flexibility in where the additional 
memory will be mapped Into the address space. In particulartbe number of pages, 
their size, and the addresses at which they may be mapped are all variable. 

Extended Memory 

Once the '286 was introduced, memofy above 1Mbyte became directly acces- 
sible. In the case of the '286 and 'ddQSX this was up to 1 6 Mbytes, for the "SSeOX 
and '486s it is 4Gbytes. The problem is that most of it is only available to programs 
written to use these chips in protected mode, w^ich MS-DOS was not, and so most 
programs are still limited to 640K. 

When an application is running in protected mode it is freed fi-om the 640K limit of 
DOS, thus all the memory on your PC is available to the application. However the 
problem arises that several programs may want to use this memory at the same 
time, and so a memory manager is required to ensure that the same bfock of 
memory is only being used by one prcigram at a time. While MS-DOS will manage 
the memory below 640K an external manager is required for extended memory. 
Several standards have evolved for these, in particular: 

XMS Extended Memory Specification. This is the most common memory manager 
as it is distributed with DOS and MS-Windows in the form of himem. sys. It 
will also manage memory between 640K and 1Mbyte on machines that 
support it, and will handle the Higher Memory Area (see below). 

VCPI Virtual Control Program Interface. This is an extension of EMS which as well 
as managing memory will switch between real mode and protected mode to 
allow code to be run outside the first 1Mbyte. Thus it will usually require a 
DOS extender. This interface to extended memory is most commonly 
provided by running EMM386 .sys. 

DPMI DOS Protected Mode Interface. This is similar to VCPI but also provides 
limited communication between the protected application and DOS, as well 
as providing some protection to memory and devices. DPMI is notable 
because it is provided by Windows 3, so an application mnning in the DOS 
Prompt window can make DPMI calls. 

One area of extended memory is accessible to programs running in real mode^ 
despite the apparent 1 Mbyte limit. This is called the High Memory Area (HMA) and 
is the first 64K of extended memory. This is directly accessible because of the 
80x86's segmented addressing scheme, in which the address is generated by 
adding the segment address to an offset: 
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19 


4 


3 C 




Segment 




Base address 


0000 








15 + 


c 




Offset 
T- , 2019 


Offset 




= 


G 




Final ™; 













If the segment base address is set to the maximum possible value, this is an 
address 16 bytes short of 1Mbyte, However the segment can extend for64K past 
this address, and so most of the first 64K of extended memory is accessible to a 
program mnning In real memory. On an 8086 this address would 'wrap-round' to 
the bottom of memory, and so to retain compatibility most '286 and higher PC's 
provide hardware which simulates this behavior (indeed it Is implemented directly 
on a '486). Because this behavior occurs when the 20th address bit is set, the 
control logic is called the 'A20 gate'. 

C.2.3 DOS Extenders 

Although the '386 provides the program running on it with a large number of 
facilities, it still requires an operating system to support it, most commonly 
MS-DOS. However this introduces some probiems, since MS-DOS runs in real 
mode, and only provides memory management for conventional memory. To allow 
a protected mode program to run, an interface between real mode and protected 
mode is required - this is the DOS extender 

The DOS extender provides several features, the most important of which are: 

• Load the application into memory and starts it running. 

• Provide the application with operating system services, which it then 
passes on to DOS for execution. 

• Provide the application with memory management functions, indepen- 
dently of the actual memory manager which is being used. 

C.3 Configuring D0S/4GW 

The DOS extender which Is used with the INMOS toolset is D0S/4GW. This 
section describes how to use the D0S4G environment variable to suppress the 
banner that is displayed by D0S/4GW at startup. It also explains how to use the 
D0S16M environment variable to select the switch mode setting, if necessary, and 
to specify the range of extended memory in which D0S/4GW will operate. 
D0S/4GW is based on Rational Systems' DOS/1 6M 16-bit protected mode 
support; hence the dos16M environment variable name remains unchanged. 



72TDS389 01 April 1993 



28 



C,3 Configuring D0S/4GW 



C.3.1 Suppressing the DOS/4GW Banner 

The banner that is displayed by DOS/4GW at startup can be suppressed by issuing 
the following command: 

3et D0S46=quiet 

Do not insert a space between D0S4G and the equals sign. A space to the right of 
the equals sign is optional. 

C.3.2 Changing the Switch Mode Setting 

in almost all cases, D0S/4GW programs can detect the type of machine that it is 
running on, and automatically choose a real to protected mode switch technique. 
For the few cases in which this default setting does not work the D0S16M DOS 
environment variable is provided, which ovenides the default setting. 

The switch mode setting can be changed by issuing the following command: 

set DOSi€H=vatue 

Do not insert a space between dosi6m and the equals sign. A space to the right 
of the equals sign is optional. 

The table below lists the machines and the settings you would use with them. The 
status column indicates if the setting will be automatically recognized (marlted 
auto) or if the DOS16M variable must be set {mari<ed required). For IBM PS/2 model 
55"s the variable may need to be set for certain machines, and so is martted 
optional. 



Machine 


Status 


Setting 


Comment 


'386/'486 with DPMI 


auto 





Set automatically if DPMI active 


NEC 98-series 


required 


n 


Must be set for 98-series 


PS/2 


auto 


2 


Set automatically for PS/2 


'386/'486 


auto 


3t 


Set automatically for '386 or '486 


'386 


auto 


INBOARD 


80386 with Intel Inboard 


Fujitsu FMR-70 


required 


5 


Must be set for Fujitsu FMR-70 


'386/*486withVCPI 


auto 


11 


Set automatically if VCPI 
detected 


Hitachi B32 


required 


14 


Must be set for Hitachi B32 


OKI if800 


required 


15 


Must be set for OKI ff800 


IBM PS/2 model 55 


optional 


16 


May be needed for some PS/2 
model 55s 


tThe mnemonic "9801" may be used instead of the number. 
tThe mnemonics "386" or "80386" may also be used. 
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If you have one of the machines listed below, set theDOSl€M environment variable 
to the value shown for the machine and specify a range of extended memory. 



Machine 


Setting 


NEC 98-series 


1 


Fujitsu FMR-60r70 


5 


Hitachi B32 


14 


OKI ifSOO 


15 



For example, if your machine is an NEC 98-series set the D0S16M environment 
variable as follows: 

Oset D0S16M=1(|2M-4M 

Note: The meaning of the characters ''@2M-4M" is described in section C.3.3, 
"Fine Control of Memory Usage", later in this chapter. 

Remember to add this command to your AUTOEXEC , BAT fife so that the D0S16M 
is set up correctly each time you switch on your PC, 

Before running toolset applications, check the mode setting by running the 
PMINFO program which can be found in the D7305A\tools directory. 

If all is well PMINFO displays a report of the proteded-mode resources available 
to your programs. The last line will be something like the following (although 
possibly with a different switch mode value): 

using D0S/16M switch mode 11 (VCPI) 

Note: in some cases PMINFO may not run correctly even though it appears that 
the DOS extender has been configured properly. However the tools may still worit 
correctly (this is because D0S/4GW has built in VCPI or DPMI host systems that 
will allow it to run while PMINFO does not). If PMINFO does not run try executing 
one of the INMOS tools supplied with this toolset. For example, the linker; 

Oilinfc 

If the linker help page is displayed then the set up is probably OK. tf the help page 
is not displayed then recheck your set up. 

Note: PMINFO will njn successfully on 80286 machines. If a program from the 
toolset does not run, and PMINFO does, check the CPU type reported by the first 
lineofthedispiay. 

C.3.3 Fine Control of Memory Usage 

In addition to setting the switch mode portion as described above, the dosi6m 
environment variable enables you to specify which portion of extended memory 
D0S/4GW will use. The variable also allows you to instruct D0S/4GW to search 
for extra memory and use it If it is present. 
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Specifying a range of Extended Memory 

Nomially, you don't need to specify a range of memory to use with the D0S16M 
environment variable. You must use the variabte, however, in the following cases: 

• You are running on a Fujitsu FMR-series, NEC 98-series OKI rfSOO-series 
or IHItachi B-series machine. 

• You have older programs that use extended memory, but don't follow one 
of the standard disciplines. 

If neither of these conditions applies, you can skip this section. 

The general syntax is: 

sat iiOSi€H= [switch mode] [^stari^address l-end_address]] [isize] 

In the syntax shown above^ start_address, end_address and size represent 
numbers, expressed in decimal or in hexadecimal (hex requires a Ox prefix). The 
number may end in a K to Indicate an address or size in kilobytes, or an M to indicate 
megabytes. If no sutTix is given than the address of size is assumed lo be in 
kilobytes. If both a size and a range are specified, than the more resblctive inter- 
pretation is used. 

The most flexible strategy is to specify only a size. However, rf you are running with 
other software that does not follow a convention for indicating its use of extended 
memory, and these other programs start before DOS/4GW, you will have to calcu- 
Jate the rage of extended memory used by the other programs and specify a range 
for D0S/4GW applications to use. 

D0S/4GW ignores specifications (or parts of specifications) that conflict with other 
information about extended memory use. Below are some examples of memory 
control: 

set DOS16M=l@2iii-4m Mode 1, for NEC 98-series machines, and use 
extended memory between 2.0 and 4.0Mbytes. 

set D0S16M=: IM Use the last full megabyte of extended memory, or as 

much as available limited to 1Mbyte. 

set D0S16M=92M Use any extended memory available above 2Mbytes. 

set DOS16»=@o-5m Use any available extended memory from 0.0 (really 
1.0)to5.0Mbytes. 

set D0S16M=: Use no extended memory. 

As a default condition toolset applications take all available extended memory that 
is not othen/vise in use. The default memory allocation strategy is to use extended 
memory if available, and overflow into DOS (low) memory. 

In a VCPI or DPMI environment, the start^address and end_address arguments 
are not meaningful. D0S/4GW memory under these protocols is not allocated 
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according to specific addresses because VCPi and DPMI automatically prevent 
address conflicts between extended memory programs. You can specify a size for 
memory managed by VCPI or DPMI, but D0Sy4GW will not necessarily allocate 
this memory from the highest available extended memory address, as it does for 
memory allocated under other protocols. 

Using Extra Memory 

Some machines contain extra non-extended, non-conventional memory just 
below 16Mbytes. When D0S/4GW runs on a Compaq 386, it automatically uses 
this memory because the memory is allocated according to a certain protocol, 
which D0S/4GW follows. Other machines have no pnDlocol for allocating this 
memory. To use the extra memory that may exist on these machines, set D0S16M 
with the + options: 

set D0S16M-+ 

Setting the + option causes D0S/4GW to search for memory in the range from 
FAOOOO to FFFFFF and determine whether the memory is usable. D0S/4GW does 
this by writing into the extra memory, and reading what it has written. In some 
cases, this memory is mapped for DOS or BIOS usage, or for other system uses. 
If D0S/4GW finds extra memory that is mapped this way, and is not marked 
read-only, it will write into that memory. If this memory is in use, this will cause a 
crash, but won't damage your system. 



C.3.4 Setting Runtime Options 

The D0S16M environment variable sets certain runtime options for all D0S/4GW 
programs running on the same system. Most of these are only useful when devel- 
oping applications under D0S/4GW, and are listed only for completeness. 
However, they may be useful when coercing toolset applications to run on 
machines that are not fully AT-compatible. 

To set the environment variable, the syntax is: 

set D0S16M= [sw!tch_mode_setting] ^options 

Note: Some command fine editing TSRs, such as CED, use the caret {^) as a 
delimiter. If you want to set DOSI6M using the above syntax above while one of 
these TSRs is resident, modify the TSR to use a different delimiter. 

The options are as follows: 

0x01 check A20 line. This option forces D0S/4GW to wait until the A20 line is 
enabled before switching to protected mode. When D0S/4GW switches to 
real mode, this option suspends your program's execution until the A20 line 
Is disabled, unless an XMS manager (such as himem.sys) is active. If an 
XMS manager is running, your program's execution is suspended until the 
A20 line is restored to the state it had when the CPU was last in real mode. 
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Specify this option If you have a machine that runs D0S/4GW but is not truly 
AT-compatible. For more information on the A20 line, see section C.3.5, 
"Controlling Address line 20". 

0x02 prevent initialization of VCPI. By default, D0S/4GW searches for a VCPl 
server and, rf one is present, forces it on. This option is useful if your applica- 
tion does not use EMS explicitly, is not a resident program, and may be used 
with '386-based EMS simulator software. 

0x04 directly pass down keyboard status calls. When this option is set, status 
requests are passed down immediately and unconditionally. When disabled 
pass-downs are limited so the 8042 auxiliary processor does not become 
overloaded by keyboard pdling loops. 

0x10 mstore only changed intenvpts. Normally, when a D0S/4GW program 
terminates, all intenupts are restored to the values they had at the time of 
program startup, When you use this option, only the intemjpts changed by 
the D0S/4GW program are restored, 

0x20 set new memory to 00. When D0S/4GW allocates a new segment or 
increases the size of a segment, the memory is zeroed. This can help you 
find bugs having k) do with uninitialized memory. You can also use it to 
provide a consistent working environment regardless of what programs were 
run eartier This option only affects segment allocations or expansions which 
are made through the D0S/4GW kernel (with DOS function 48H or 4AH). 
This option does not affect memory allocated with a compiler's malloc() 
function. 

0x40 set new memory to FR When DOS/4GW allocates a new segment or 
Increases the size of a segment, the memwy is set to OxFF bytes. This is 
helpful in maldng reproducible cases of bugs caused by uninitialized 
memory. This option only affects segment allocations or expansions which 
are made through the D0S/4GW kernel (with DOS function 48H or 4AH). 
This optksn does not affect memory allocated with a compiler's mallocO 
function. 

0x80 new selector rotation. When D0S/4GW allocates a new selector, it usually 
kx>ks for the first available (unused) selector in numerical order starting with 
the highest selector used when the program was loaded. When the option 
is setj the new selector search begins after the last selector was allocated. 
This causes new selectors to rotate through the range. Use this option to find 
references to stale selectors, i.e., segments that have been canceled or 
treed. 

C.3.5 Contrcrfling Address line 20 

This sednn describes how D0S/4GW uses address line 20 (A20) and describes 
the related DOSl^ env^nment variable settings. It is unlikely that you will need 
to use these settings. 

Because the 8086 and 8088 chips have a 20-bit address space, their highest 
addressable memory location is one byte below 1 Mbyte. If you specily an address 
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at 1Mbyte or over, which would require a twenty-first bit to be set, the address 
wraps back to zero. Some parts of DOS depend on this wrap, so on the 80286 and 
80386, the twenty-frrst address line is disabled. To address extended memory, 
D0S/4GW enables the twenty-first address bit (the A20 fine). The A20 line must 
be enabled for the CPU to run In protected mode, but it may be either enabled or 
disabled in real mode. 

By default, when D0S/4GW returns to real mode, It disables the A20 line. Some 
software depends on the line being enabled. D0S/4GW recognizes the most 
common software in this class, the XMS managers (such as himem.sys), and 
enables the A20 line when it returns to real mode if an XMS manager is present. 
For other software that requires the A20 line to be enabled, use the A20 option. 
The A20 option makes D0S/4GW restore the A20 line to the setting it had when 
D0S/4GW switched to protected mode. Set the environment variable as follows: 

set DOS16M=A20 

To specify more than one option on the command line, separate the options with 
spaces. 

The D0S16M variable also lets you specify the length of the deiay between a 
D0S/4GW instruction to change the status of the A20 line and the next DGS/4GW 
operation. By default, this delay is 1 loop instruction when D0S/4GW is running 
on a '386 machine. In some cases, you may need to spedfy a longer delay for a 
machine that will run D0S/4GW but is not truly AT-compatible. To change the 
delay, set the D0S16M to the desired number of loop instructions, preceded by a 
comma: 

set DOS 16M=^ /oops 
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C.4 PMINFO 

Purpose Measures the performance of protected/real-mode switching and 
extended memory, 

SyntaXFHINFO.EXE 

Notes The time-based measurements made by PMINFO may vary siightly from 
run to run. 

Example The followtng example shows the output of the PMINFO program on an 
80486 AT-compatibie machine. 

Pzotactad Hod* and Xxtuidad Muiofy Farfomanc* H«Mur«Miit — 3.95 
CQpyti^t 1983 r 1989, 1990 by Rational Syatama, Inc. 

DOS Hwnory Extandad msnory CPa la 33.7 HHx B0I86. 



639 7040 K bytaa configuzad (according Co BIOS) . 

540 7168 K bytaa phyalcally praaant (SITITP) . 

477 7040 K bytaa avallabla for DOS/IGH pzograma. 

(D03/16H Dwrnory rang* 108SK to B126K} 
21.2 (0.0) 21.2 (0.0) HB/aac word tranafar rata (wait atataa) . 

42.1 (0.0) 40.1 (0.5) MB/aac 32-bit tranafar rata (wait atataa) . 

Orazall c^u and niamory parformanca (non-floating point) for typical 
DOS programa ia 8.32 +/- 0.67 timaa an 8MHz IBM PC/XT. 

Frotactad/Raal awitch rata - I6l24/aac («2 uaac/awltdi, 32 19 + 29 down) , 
UJitig D0S/1£U awitcb moda 3 (386) . 

The top information line shows that the CPU is an Intel 80486 processor 
running at 33.7MHz. Below are the configuration and timings for both the 
DOS mem ory and the extended memory. If the com puter is not equi pped with 
extended memory, or none is available for D0S/4GW, the extended memory 
measurements may be omitted ('-"). 

The line "according to BIOS" shows the information provided by the BIOS 
(interrupts 21 h and 1 5h funcOon 88h). The line "SETUP", if displayed, is the 
configuration obtained directly from the CMOS RAM as set by the computers 
setup progi^m. It is only displayed if the numbers are different from those in 
the BIOS line. They will be different for computers where the BIOS has 
reserved memoryforitself or if another program has allocated some memory 
and is intercepting the BIOS configuration requests to report less memory 
available than is physically configured. The "DOS/1 6M memory range", if 
displayed, shows the low and high addresses available to D0S/4GW in 
extended memory. 

Below the configuration information is infonnation on the memory speed 
{transfer rate). PMINFO tries to determine the memory architecture. Some 
architectures will perform well under certain circumstances and poorly under 
others; PMINFO will show both the best and worst cases. The architectures 
detected are cache, interleaved, page-mode (or static column), and direct. 
Measurements are made using 32-bit accesses and reported as the number 
of megabytes per second that can be transferred. The number of wait states 
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is reported in parentheses. The wait states can be a fractional number, like 
0.5, if there is a wait state on writes but not on reads. Memory bandwidth (i.e. 
how fast the CPU can access memory) accounts for 60% to 70% of the 
performance for typical progra ms (that are not heaviiy dependent on floating- 
point arithmetic). 

A performance metric developed by Rational Systems is displayed, showing 
the expected throughput for the computer relative to a standarxJ 8MHz IBM 
PC/AT (disk accesses and floating point are excluded). Rnallythe speed with 
which the computer can switch between real and protected mode is 
displayed, both as the maximum number of round-trip switches that can 
occur per second, and the time for a single round trip switch, broken out into 
the real-to-protected (up) and protected-to-real (down) components. 

C,5 RMINFO 

Purpose Supplies configuration information and the basis for real/protected- 
mode switching in your machine. 

Syntax rminfo . exe 

Notes RMINFO starts up D0S/4GW, but stops your machine just short of 
switching from real mode to protected mode and displays configuration 
information about your computer. The information shown by RMINFO can 
help detemiine why D0S/4GW applications won't run on a particular 
machine. Run RMINFO if RMINFO does not njn to completion. 

Example The following example shows the output of the RMINFO program on an 
80486 AT-compatible machine, 

CanfigurAtlon infomaU.Dii: 

H&chln* configuration: Intel 80i86 proceaaor {delays miknoiai} 

Has an fC or XT BlOfi: No 

Tripl* fault flag: On 

Addreas line 20 rigor: No 

Addreaa lin« 2Q: Off 

Addrsas lina 20 orig. : Off 
Operating system is DOS 5.0 

VDISK device found: No 

QEJn! device found: No 

XHS system found: No 
Hauory 

Configured memory: Basa ID24K, Size 15360K, Top ie384K 

Actual memory: Kase 1024^, Top 8192K 

Unallocated itwmory: 7168X[ 
DOS/16H version 3.95 

This is the first copy of DOS/1 6H. 

Switch control flags: 0000 

Switch method: 3 (80386) 

Available mei&ory: 7163K [0] 

No VCPI paga tabla. 

VCFI not in tiae. 
End of configuration information 

The infomiation provided by RMINFO includes; 
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Triple fault flag Whether triple faulting is used to switch back to real mode 
from protected mode. 

Address line 20 rigor Whether D0S/4GW rigorously controls enabling and 
disabling of Address line 20 when switching modes. 

Address line 20 Cun^ent state of Address line 20. 

Address line 20orig. Original state of Address line 20. 

VDISK device found Whether your system has any software using 
extended memory under the VDISK discipline. 

QE)CT device found Whetheryour system has any software using extended 
memory under the QEXT discipline. 

XMS device found Whether your system has any software using extended 
memory under the XMS disctpltne. 

Configured memory Amount of memory D0S/4GW wll try to use. 

Actual memory Amount of memory D0S/4GW can actually use. 

TTiis is the . . . This number will vary according to how many copies of 
D0S/4GW or DOS/1 6M-b35ed applications are cun-ently active on your 
system. 

VGPI (not) In use If your system has any software using extended memory 
under the VCPi discipline. 
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